home *** CD-ROM | disk | FTP | other *** search
/ IRIX Base Documentation 2001 May / SGI IRIX Base Documentation 2001 May.iso / usr / share / catman / g_man / cat3 / ftn / arcf.z / arcf
Encoding:
Text File  |  1998-10-20  |  6.8 KB  |  133 lines
  1.  
  2.  
  3.  
  4. aaaarrrrccccffff((((3333GGGG))))                                                              aaaarrrrccccffff((((3333GGGG))))
  5.  
  6.  
  7.  
  8. NNNNAAAAMMMMEEEE
  9.      aaaarrrrccccffff,,,, aaaarrrrccccffffiiii,,,, aaaarrrrccccffffssss - draw a filled circular arc
  10.  
  11. FFFFOOOORRRRTTTTRRRRAAAANNNN 77777777 SSSSPPPPEEEECCCCIIIIFFFFIIIICCCCAAAATTTTIIIIOOOONNNN
  12.      ssssuuuubbbbrrrroooouuuuttttiiiinnnneeee aaaarrrrccccffff((((xxxx,,,, yyyy,,,, rrrraaaaddddiiiiuuuussss,,,, ssssttttaaaannnngggg,,,, eeeennnnddddaaaannnngggg))))
  13.      rrrreeeeaaaallll xxxx,,,, yyyy,,,, rrrraaaaddddiiiiuuuussss
  14.      iiiinnnntttteeeeggggeeeerrrr****4444 ssssttttaaaannnngggg,,,, eeeennnnddddaaaannnngggg
  15.  
  16.      ssssuuuubbbbrrrroooouuuuttttiiiinnnneeee aaaarrrrccccffffiiii((((xxxx,,,, yyyy,,,, rrrraaaaddddiiiiuuuussss,,,, ssssttttaaaannnngggg,,,, eeeennnnddddaaaannnngggg))))
  17.      iiiinnnntttteeeeggggeeeerrrr****4444 xxxx,,,, yyyy,,,, rrrraaaaddddiiiiuuuussss,,,, ssssttttaaaannnngggg,,,, eeeennnnddddaaaannnngggg
  18.  
  19.      ssssuuuubbbbrrrroooouuuuttttiiiinnnneeee aaaarrrrccccffffssss((((xxxx,,,, yyyy,,,, rrrraaaaddddiiiiuuuussss,,,, ssssttttaaaannnngggg,,,, eeeennnnddddaaaannnngggg))))
  20.      iiiinnnntttteeeeggggeeeerrrr****2222 xxxx,,,, yyyy,,,, rrrraaaaddddiiiiuuuussss
  21.      iiiinnnntttteeeeggggeeeerrrr****4444 ssssttttaaaannnngggg,,,, eeeennnnddddaaaannnngggg
  22.  
  23.      All of the routines named above are functionally the same.  They differ
  24.      only in the type assignments of their parameters.
  25.  
  26. PPPPAAAARRRRAAAAMMMMEEEETTTTEEEERRRRSSSS
  27.      _x          expects the _x coordinate of the center of the filled arc. The
  28.                 center of the filled arc is the center of the circle that
  29.                 would contain the arc.
  30.  
  31.      _y          expects the _y coordinate of the center of the filled arc. The
  32.                 center of the filled arc is the center of the circle that
  33.                 would contain the arc.
  34.  
  35.      _r_a_d_i_u_s     expects the length of the radius of the filled arc.  The
  36.                 radius of the filled arc is the radius of the circle that
  37.                 would contain the filled arc.
  38.  
  39.      _s_t_a_n_g      expects the measure (in tenths of a degree) of the start angle
  40.                 of the filled arc. The start angle of the filled arc is
  41.                 measured relative to the positive x-axis.
  42.  
  43.      _e_n_d_a_n_g     expects the measure (in tenths of a degree) of the end angle
  44.                 of the filled arc.  The end angle of the filled arc is
  45.                 measured relative to the positive x-axis.
  46.  
  47. DDDDEEEESSSSCCCCRRRRIIIIPPPPTTTTIIIIOOOONNNN
  48.      aaaarrrrccccffff draws a filled circular arc in the _x-_y plane (_z = _0).  The filled
  49.      area is bound by the arc and by the start and end radii. To draw an arc
  50.      in a plane other than the _x-_y plane, define the arc in the _x-_y plane and
  51.      then rotate or translate the arc.
  52.  
  53.      An arc is drawn as a single polygon, and therefore inherits all
  54.      properties that affect the drawing of polygons.  These include the
  55.      current color, writemask, fill pattern, shade model, polygon antialiasing
  56.      mode, polygon scan conversion mode, and subpixel mode.  Front-face and
  57.      back-face elimination work correctly with filled arcs, which are front-
  58.      facing when viewed from the positive z half-space.  Some polygon modes
  59.      are applicable only if old-style scan conversion is defeated.  (See note
  60.  
  61.  
  62.  
  63.                                                                         PPPPaaaaggggeeee 1111
  64.  
  65.  
  66.  
  67.  
  68.  
  69.  
  70. aaaarrrrccccffff((((3333GGGG))))                                                              aaaarrrrccccffff((((3333GGGG))))
  71.  
  72.  
  73.  
  74.      below.)
  75.  
  76.      A filled arc is defined in terms of the circle that contains it.  All
  77.      references to the radius and the center of the filled arc refer to the
  78.      radius and center of the circle that contains the filled arc. The angle
  79.      swept out by the filled arc is the angle from the start angle counter-
  80.      clockwise to the end angle.
  81.  
  82.      The start and end angles are defined relative to the positive x-axis. (To
  83.      speak more precisely, because the arc might not be centered on the
  84.      origin, the start and end angles are defined relative to the right
  85.      horizontal radius of the circle containing the arc.)  Positive values for
  86.      an angle indicate a counter-clockwise rotation from the horizontal.
  87.      Negative values indicate a clockwise rotation from the horizontal.
  88.  
  89.      The basic unit of angle measure is a tenth of a degree. The value 900
  90.      indicates an angle of 90 degrees in a counter-clockwise direction from
  91.      the horizontal. Thus, a filled arc that spans from a start angle of 10
  92.      degrees (_s_t_a_n_g = _1_0_0) to an end angle of 5 degrees (_e_n_d_a_n_g = _5_0) is
  93.      almost a complete filled circle.
  94.  
  95.      After aaaarrrrccccffff executes, the graphics position is undefined.
  96.  
  97. SSSSEEEEEEEE AAAALLLLSSSSOOOO
  98.      arc, backfa, bgnpol, circf, frontf, glcomp, polymo, polysm, scrsub,
  99.      setpat, shadem, subpix
  100.  
  101. NNNNOOOOTTTTEEEE
  102.      By default aaaarrrrccccffff draws a polygon using the old-style scan conversion
  103.      algorithm, rather than the point sampling algorithm used by bbbbggggnnnnppppoooollll and
  104.      eeeennnnddddppppoooollll.  Point sampling is prefered over old-style scan conversion
  105.      because it has higher performance, it results in higher-quality images
  106.      when blending, logical operations, or stenciling are used, and it
  107.      supports new rendering features such as texture mapping, fog, and
  108.      antialiasing.  Call ggggllllccccoooommmmpppp((((GGGGLLLLCCCCOOOOLLLLDDDD,,,,0000)))) to enable point sampling of polygons
  109.      generated by aaaarrrrccccffff.
  110.  
  111.  
  112.  
  113.  
  114.  
  115.  
  116.  
  117.  
  118.  
  119.  
  120.  
  121.  
  122.  
  123.  
  124.  
  125.  
  126.  
  127.  
  128.  
  129.                                                                         PPPPaaaaggggeeee 2222
  130.  
  131.  
  132.  
  133.